Escribir en

UiPath.UIAutomationNext.Activities.NTypeInto

Descripción

Introduce texto en un elemento específico de la IU, por ejemplo, un cuadro de texto.

También puedes enviar teclas especiales como Tabulador o Intro al elemento de la IU.

Las teclas adhesivas también son compatibles. Por ejemplo, si quieres escribir Shift+End para seleccionar solo una parte del texto de un control, debes seleccionar Shift y End de la lista de teclas especiales y el texto propuesto es [k(Shift)][k(End)]. Esto emula las pulsaciones de las teclas Shift y End forma secuencial. El texto correcto es [d(Shift)][k(End)][u(Shift)], donde d significa tecla abajo, k significa tecla pulsada y u significa tecla arriba.

Si quieres introducir información confidencial de forma segura, añade una actividad Obtener nombre de usuario/contraseña antes de esta actividad y selecciona los valores de nombre de usuario y contraseña guardados para más tarde de esa actividad como texto a escribir.

Esta actividad debe añadirse dentro de una actividad Usar aplicación/navegador.

Esta actividad es compatible con el repositorio de objetos.

Para aprender a usar esta actividad, consulte:

Requisitos previos para introducir la información de inicio de sesión de forma segura

Antes de poder introducir la información de nombre de usuario / contraseña de forma segura utilizando esta actividad, primero debe:

Añade una actividad Obtener nombre de usuario / contraseña al proyecto.
En la actividad Obtener nombre de usuario / contraseña , selecciona las credenciales guardadas previamente en el Administrador de credenciales de Windows. Si las credenciales que deseas usar no están guardadas en el Administrador de credenciales de Windows, puedes usar esta actividad para agregarlas.
Guarde las credenciales para usarlas posteriormente en el proyecto.

Compatibilidad de proyectos

Windows: heredado | Windows | Multiplataforma

Windows (heredado), configuración de Windows

Panel del Diseñador

Haz clic en Indicar en aplicación / navegador para indicar el elemento de IU que se utilizará como destino.

Este paso no es necesario si el elemento ya está enfocado en la aplicación de destino.

Después de indicar el destino, seleccione el menú para acceder a las siguientes opciones:
- Indicar destino en pantalla: indica de nuevo el destino.
- Editar objetivo : abre el modo de selección para configurar el objetivo.
- Añadir verificación automática: verifica si las Actions realizadas por la actividad eran correctas.
- Eliminar captura de pantalla informativa : elimina la captura de pantalla de la aplicación o página web de destino.
- Añadir al repositorio de objetos : añade el elemento de IU actual a un proyecto de biblioteca, desde donde pueda reutilizarse en todo el proceso de automatización.
Escribir esto : el texto a introducir. Puedes usar el menú desplegable para seleccionar una clave especial para enviar al campo de texto o puedes añadir claves especiales desde el Generador de Textos. También puede utilizar las opciones del Más dentro del Generador de Textos para agregar valores guardados para más tarde o agregar datos desde el Manual del proyecto o actividades principales Usar archivo de Excel o Usar cuenta de Outlook . Se admite cualquier combinación de texto, datos de Excel o Outlook y teclas especiales.
Vaciar campo antes de escribir : selecciona si deseas eliminar el contenido existente en el campo antes de escribir el texto y cómo vaciar el campo. Los campos se vacían enviando una combinación de pulsaciones de teclas que difiere entre campos con una sola línea y campos con varias líneas. Asegúrese de seleccionar la opción correcta en función del campo indicado. Las opciones son:
- Ninguno : no elimina el contenido existente.
- Línea única (Fin, Mayús + Inicio, Supr) : elimina el contenido de un campo de texto con una sola línea. Esta es la opción predeterminada.
- Línea múltiple (Ctrl + A, Supr) : elimina el contenido de un campo de texto con varias líneas.
Para usar la actividad para borrar el campo de texto indicado, configura esta propiedad para eliminar el contenido existente, deja el campo Escribir esto vacío y establece la propiedad Modo de entrada en Eventos de hardware.
Hacer clic antes de escribir : selecciona si quieres hacer clic en el elemento de la IU especificado antes de escribir el texto y el tipo de clic que quieres hacer. Las opciones son Ninguno (no hacer clic), Único (ejecutar un solo clic) o Doble (ejecutar un doble clic).

La opción predeterminada es Único.
Verificar que el texto está vacío : esta opción aparece si se selecciona Añadir verificación automática . Puede indicar en la aplicación actual o en cualquier aplicación.

Panel de propiedades

Común

Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está en blanco y se produce un error, se detiene la ejecución del proyecto. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.
Retraso después de : retraso (en segundos) entre el momento en que se completa esta actividad y el momento en que la siguiente actividad inicia cualquier operación. El valor predeterminado es 0,3 segundos. Agregar un retraso entre actividades garantiza que una actividad tenga tiempo suficiente para completarse antes de que comience la siguiente.
Retraso antes de: retraso (en segundos) entre la hora a la que se termina la actividad anterior y la hora a la que esta actividad empieza a ejecutar operaciones. El valor predeterminado es 0,2 segundos. Añadir un retraso entre actividades garantiza que una actividad tiene tiempo suficiente para completarse antes de que comience la actividad siguiente.
Nombre paramostrar : el nombre que se muestra para la actividad en el panel Diseñador. Se genera automáticamente un nombre para mostrar cuando indica un destino.
Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.

Entrada

Texto seguro : el texto seguro a introducir. El campo solo admite variables CadenaSegura. Si se configura este campo, se borra el campo Texto . La longitud máxima de la cadena para este campo es de 65536 caracteres.
Destino : el elemento de destino. Se debe establecer el elemento de destino. Antes de indicarlo en la pantalla, este campo se establece como (null). Una vez que se indica el destino, se muestran todas las propiedades relacionadas con el elemento que se indicó.
- Desplazamiento declic : especifica un desplazamiento para la actividad de clic, que se puede configurar posteriormente.
  - Punto deanclaje : describe el punto de inicio del cursor al que se agregan las propiedades Desplazamiento X y Desplazamiento Y. Las siguientes opciones están disponibles: Izquierda superior, derecha superior, izquierda inferior, derecha inferiory centro. De forma predeterminada, se selecciona Centro .
  - Desplazamiento X : desplazamiento horizontal de la posición del cursor según la opción seleccionada en el campo Punto de anclaje . Este campo solo admite variables Int32 .
  - Desplazamiento Y : desplazamiento vertical de la posición del cursor según la opción seleccionada en el campo Punto de anclaje . Este campo solo admite variables Int32 .
- Tipo de control CV : indica el tipo de control identificado mediante Computer Vision.
- Texto de CV : indica el texto identificado mediante Computer Vision.
- Selector difuso : los parámetros para el selector difuso.
- Texto nativo : el texto que se utiliza para identificar el elemento de la interfaz de usuario.
- Páginas web dinámicas: habilita el diseño de páginas web dinámicas.
- Selector estricto: el selector estricto generado para el elemento de IU.
- Métodos de destino: los tipos de selectores que quieres utilizar para identificar el elemento. Esta propiedad se puede establecer en cualquier combinación del menú desplegable:
  - Ninguno
  - Selector estricto
  - Selector difuso
  - Imagen
  - Texto nativo
  - Computer Vision
- Comprobación devisibilidad: comprueba si el elemento de la IU está visible o no. Puedes elegir una de las tres opciones del menú desplegable:
  - Ninguno : no comprueba la visibilidad.
  - Interactivo (para selector difuso) : opción predeterminada. Comprueba si el elemento es potencialmente visible, ignorando el desplazamiento de página y las obstrucciones de otras aplicaciones, o el hecho de que la aplicación está minimizada. Esta comprobación es útil cuando intenta asegurarse de que no está apuntando a elementos invisibles que existen en el DOM pero que están ocultos.
  - Totalmente visible : comprueba si el elemento de la IU está visible o no.
- Esperar a que se cargue la página : antes de realizar las Actions, espera a que la aplicación esté lista para aceptar la entrada. Puedes elegir una de las tres opciones del menú desplegable:
  - Ninguno: No espera a que el objetivo esté listo.
  - Interactivo: espera hasta que se cargue solo una parte de la aplicación.
  - Completo: espera a que se cargue la aplicación completa.
- Selector de ventana (instancia de aplicación) : el selector que se utiliza para la ventana de la aplicación. Solo se aplica cuando el modo de agregación de ventana está establecido en Instancia de aplicación.
Texto : el texto a introducir. Puedes añadir teclas especiales al texto desde la lista desplegable en el cuerpo de la actividad. Si se configura este campo, se borra el campo de Texto seguro . La longitud máxima de la cadena para este campo es de 65536 caracteres.
Verificar ejecución : en Runtime, verifica si las Actions realizadas por la actividad eran correctas. Esto se hace verificando si el texto especificado en la propiedad Texto esperado se encuentra en el elemento de IU indicado después de que se ejecute la actividad, o indicando un elemento que debe aparecer o desaparecer después de realizar las Actions , que se supervisa y verifica después se ejecuta la actividad. Esta característica se puede habilitar desde la Configuración del proyectoo desde el cuerpo de la actividad seleccionando Agregar verificación automática en el menú contextual.
- Nombre para mostrar: el nombre para mostrar de las Actionsde verificación. Este campo se rellena automáticamente en función de las Actions de verificación y el elemento que haya elegido. Una vez que se configura Verificar ejecución , este nombre para mostrar se vuelve visible en la tarjeta de actividad.
- Texto esperado : el texto que se espera que se escriba en el campo de texto especificado. Este campo es opcional. Este campo solo admite cadenas y variables String .
- Reintentar : cuando se selecciona, las Actions se vuelven a intentar durante el tiempo de espera de la actividad si no se alcanzó el resultado esperado. Esta casilla de verificación está seleccionada de forma predeterminada.
- Destino : este destino se utiliza para indicar el elemento que quieres verificar en tiempo de Runtime. Para obtener más información sobre los campos de propiedad que se pueden expandir con esta propiedad, consulta la propiedad Destino anterior, ya que la funcionalidad de las propiedades es la misma.
- Tiempo de espera: la cantidad de tiempo (en segundos) para esperar a que aparezca, desaparezca o cambie el elemento de verificación. Si se selecciona la casilla Reintentar , las Actions se realizan de nuevo, seguidas de la verificación, durante el tiempo especificado en la propiedad Tiempo de espera de la actividad. El valor predeterminado es 10 segundos.
- Verificar elemento : define el cambio para el que quieres comprobar el objetivo de verificación. Las opciones disponibles son:
  - Aparecido : comprueba si el elemento aparece.
  - Desapareció : comprueba si el elemento desaparece.
  - Texto cambiado : comprueba si hay algún cambio en el texto del elemento.
  - Cambiado visualmente : comprueba si hay algún cambio en la imagen del elemento.

Elemento de entrada/salida

Elemento deentrada: el elemento de IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite UIElement objetos. Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de automatización de IU.
Elemento desalida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede usarse para señalar el mismo elemento con otras actividades.

Otros

Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.

Opciones

Alterar elemento deshabilitado : si se selecciona, la actividad ejecuta las Actions incluso si el elemento de la IU especificado está deshabilitado. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.

Esta propiedad no se aplica si la propiedad Modo de entrada está configurada como Eventos de hardware.
Modo de entrada : selecciona qué método debe utilizar el robot para interactuar con la aplicación de destino:
- Igual que aplicación / navegador : utiliza el mismo modo de entrada que la actividad Usar aplicación / navegador .
  
  Esta es la selección predeterminada.
- Eventos de hardware : utiliza el controlador de hardware para realizar la acción. Este es el método más lento, no funciona en segundo plano, pero es compatible con todas las aplicaciones de escritorio.
- Simular : simula mediante API de accesibilidad. Recomendado para navegadores, aplicaciones basadas en Java, SAP. Suele ser más fiable que los eventos de hardware. Envía todo el texto en una sola Actions. Funciona incluso si la aplicación de destino no está enfocada. Pruebe si el elemento de la interfaz de usuario de su aplicación de destino lo admite.
  
  En el panel Propiedades, la junto al campo de propiedad Modo de entrada prueba y selecciona automáticamente el modo de entrada correcto para las Actions que está realizando. Con esta característica, el texto se escribe en el campo de destino con todos los métodos de entrada disponibles y se elige automáticamente el que ofrece el mejor rendimiento.
  
  Las propiedades Activar, Hacer clic antes de escribir, Retraso entre teclasy Vaciar campo no se pueden utilizar con el modo de entrada Simular.
- API de Chromium : realiza acciones utilizando las API del depurador. Solo funciona para elementos de Chromium. Envía todo el texto de una vez. Funciona incluso si la aplicación de destino no está enfocada. Para obtener más información, consulta esta página.
- Mensajes de ventana : simula usando mensajes Win32. Recomendado para aplicaciones de escritorio. Suele ser más fiable que los eventos de hardware. Envía todo el texto en una sola Actions. Funciona incluso si la aplicación de destino no está enfocada. Pruebe si el elemento de la interfaz de usuario de su aplicación de destino lo admite.

Opciones: eventos de hardware / API de Chromium

Activar : trae el elemento de IU al primer plano y actívalo antes de hacer clic en él. Si no está seleccionado, la actividad se escribe en la ventana activa actual. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Verdadero.
Hacer clic antes de escribir : consulta Hacer clic antes de escribir en el panel Diseñador.
Retraso entre teclas : retraso (en segundos) entre pulsaciones de teclas consecutivas. El valor predeterminado es 0,02 segundos. El valor máximo es de 1 segundo.
Campo vacío : consulta Campo vacío antes de escribir en el panel Diseñador.

Opciones: simulación

Anular selección al final : esta casilla de verificación solo se puede usar cuando la propiedad Modo de entrada está establecida en Simular y está seleccionada de forma predeterminada. Algunas aplicaciones de destino no registran una acción de tipo a menos que también se envíe un evento Completo junto con la acción. Al seleccionar esta casilla de verificación se añade un evento Completo después de la entrada de texto, para registrar la acción correctamente. Si se desactiva esta casilla de verificación, el evento Complete no se envía a la aplicación de destino. Esta casilla de verificación está seleccionada de forma predeterminada.

Configuración multiplataforma

Trabajar en el ámbito : elija la pestaña del navegador que representa la aplicación web que se va a automatizar.
Indicar destino en pantalla : indica el elemento de la IU que se usará como destino.

Después de indicar el destino, selecciona el botón más para acceder a las siguientes opciones:
- Indicar destino en pantalla: indica de nuevo el destino.
- Editar objetivo : abre el modo de selección para configurar el objetivo.
Escribir esto : el texto a introducir. Puedes añadir claves especiales desde el Generador de Textos.

Opciones adicionales

Plazos

Retraso antes de: retraso (en segundos) entre la hora a la que se termina la actividad anterior y la hora a la que esta actividad empieza a ejecutar operaciones. El valor predeterminado es 0,2 segundos. Añadir un retraso entre actividades garantiza que una actividad tiene tiempo suficiente para completarse antes de que comience la actividad siguiente.
Retraso después de : retraso (en segundos) entre el momento en que se completa esta actividad y el momento en que la siguiente actividad inicia cualquier operación. El valor predeterminado es 0,3 segundos. Agregar un retraso entre actividades garantiza que una actividad tenga tiempo suficiente para completarse antes de que comience la siguiente.
Tiempo de espera: especifica la cantidad de tiempo (en segundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 30 segundos.
Continuar en caso de error : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está en blanco y se produce un error, se detiene la ejecución del proyecto. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Opciones

Campo vacío: selecciona si eliminar el contenido existente en el campo antes de escribir el texto y cómo vaciar el campo. Los campos se vacían al enviar una combinación de pulsaciones de teclado que difieren entre los campos con una sola línea y los que contienen múltiples líneas. Asegúrate de seleccionar la opción correcta dependiendo del campo indicado.Las opciones son:
- Ninguno : no elimina el contenido existente.
- Línea única (Fin, Mayús + Inicio, Supr) : elimina el contenido de un campo de texto con una sola línea. Esta es la opción predeterminada.
- Línea múltiple (Ctrl + A, Supr) : elimina el contenido de un campo de texto con varias líneas.
Hacer clic antes de escribir : selecciona si quieres hacer clic en el elemento de la IU especificado antes de escribir el texto y el tipo de clic que quieres hacer. Las opciones son Ninguno (no hacer clic), Único (ejecutar un solo clic) o Doble (ejecutar un doble clic). La opción predeterminada es Único.
Activar : si se selecciona, el elemento de la IU especificado se trae al primer plano y se activa antes de escribir el texto. Si no está seleccionado, la actividad se escribe en la ventana activa actual. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Verdadero.
Anular selección al final : añade un evento Completo después de la entrada de texto para activar ciertas respuestas de IU en los navegadores web.
Modo de entrada : selecciona qué método debe utilizar el robot para interactuar con la aplicación de destino:
- Igual que el navegador : usa la configuración del modo de entrada de la actividad principal Usar navegador . Esta es la opción predeterminada.
- API Chromium: realiza acciones mediante las API de depuración. Funciona solo para elementos Chrome y Edge. Envía todo el texto de una vez. Funciona incluso si la aplicación de destino no está enfocada.
- Simular : simula el clic mediante las API de accesibilidad. Funciona para navegadores. Envía todo el texto de una vez. Este método de entrada funciona en segundo plano (incluso si la aplicación de destino no está enfocada).

Entrada/Salida

Elemento deentrada: el elemento de IU en el que se ejecuta la actividad, almacenado en un objeto UIElement . Este campo solo admite UIElement objetos. Este objeto se puede obtener del campo de propiedad Elemento de salida de otras actividades de automatización de IU.
Elemento desalida : genera un elemento de IU de destino y lo almacena en un objeto UIElement , que puede usarse para señalar el mismo elemento con otras actividades.